Correct the docs.
authorMatthias Clasen <maclas@gmx.de>
Thu, 12 Feb 2004 01:52:26 +0000 (01:52 +0000)
committerMatthias Clasen <matthiasc@src.gnome.org>
Thu, 12 Feb 2004 01:52:26 +0000 (01:52 +0000)
Thu Feb 12 02:22:02 2004  Matthias Clasen  <maclas@gmx.de>

* gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func):
Correct the docs.

Thu Feb 12 02:00:53 2004  Matthias Clasen  <maclas@gmx.de>

* gtk/tmpl/gtktreemodelfilter.sgml:
* gtk/tmpl/gtkentrycompletion.sgml:
* gtk/tmpl/gtkcelllayout.sgml: Additions.

Thu Feb 12 01:27:02 2004  Matthias Clasen  <maclas@gmx.de>

* gtk/gtk-sections.txt: Updates.

Thu Feb 12 01:26:42 2004  Matthias Clasen  <maclas@gmx.de>

* gtk/Makefile.am (IGNORE_HFILES): Add some private headers.

12 files changed:
ChangeLog
ChangeLog.pre-2-10
ChangeLog.pre-2-4
ChangeLog.pre-2-6
ChangeLog.pre-2-8
docs/reference/ChangeLog
docs/reference/gtk/Makefile.am
docs/reference/gtk/gtk-sections.txt
docs/reference/gtk/tmpl/gtkcelllayout.sgml
docs/reference/gtk/tmpl/gtkentrycompletion.sgml
docs/reference/gtk/tmpl/gtktreemodelfilter.sgml
gtk/gtktreemodelfilter.c

index 695eafb0491a748d3989972eb30576ab34ebfd90..49eba098e170a5672aeb4a21c434a5222d5c852f 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Thu Feb 12 02:22:02 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Correct the docs.
+
 Thu Feb 12 01:17:01 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_enable_model_drag_source): Call
index 695eafb0491a748d3989972eb30576ab34ebfd90..49eba098e170a5672aeb4a21c434a5222d5c852f 100644 (file)
@@ -1,3 +1,8 @@
+Thu Feb 12 02:22:02 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Correct the docs.
+
 Thu Feb 12 01:17:01 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_enable_model_drag_source): Call
index 695eafb0491a748d3989972eb30576ab34ebfd90..49eba098e170a5672aeb4a21c434a5222d5c852f 100644 (file)
@@ -1,3 +1,8 @@
+Thu Feb 12 02:22:02 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Correct the docs.
+
 Thu Feb 12 01:17:01 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_enable_model_drag_source): Call
index 695eafb0491a748d3989972eb30576ab34ebfd90..49eba098e170a5672aeb4a21c434a5222d5c852f 100644 (file)
@@ -1,3 +1,8 @@
+Thu Feb 12 02:22:02 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Correct the docs.
+
 Thu Feb 12 01:17:01 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_enable_model_drag_source): Call
index 695eafb0491a748d3989972eb30576ab34ebfd90..49eba098e170a5672aeb4a21c434a5222d5c852f 100644 (file)
@@ -1,3 +1,8 @@
+Thu Feb 12 02:22:02 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Correct the docs.
+
 Thu Feb 12 01:17:01 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_enable_model_drag_source): Call
index cf17da0d93d8bdda5b6cd960a62f88e9b93f2517..ac6cfe05bd32814c509605dea17ffc761dcf79d0 100644 (file)
@@ -1,3 +1,17 @@
+Thu Feb 12 02:00:53 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/tmpl/gtktreemodelfilter.sgml: 
+       * gtk/tmpl/gtkentrycompletion.sgml: 
+       * gtk/tmpl/gtkcelllayout.sgml: Additions.
+
+Thu Feb 12 01:27:02 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtk-sections.txt: Updates.
+
+Thu Feb 12 01:26:42 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/Makefile.am (IGNORE_HFILES): Add some private headers.
+
 Sat Feb  7 00:38:23 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtk-sections.txt: Add GtkAccelMap, gtk_accel_map_get,
index a40008fa1a91f95f8e66222cda8b54bbaedae4d3..dc96cf3ed1c123a810b45059d17a530822947a7e 100644 (file)
@@ -26,9 +26,13 @@ IGNORE_HFILES=                               \
        fnmatch.h                       \
        gdk-pixbuf-loader.h             \
        gtkcellrendererseptext.h        \
+       gtkcellview.h                   \
+       gtkcellviewmenuitem.h           \
        gtkdebug.h                      \
+       gtkentryprivate.h               \
        gtkfilechooserdefault.h         \
        gtkfilechooserentry.h           \
+       gtkfilechooserprivate.h         \
        gtkfilechooserutils.h           \
        gtkfilesystem.h                 \
        gtkfilesystemmodel.h            \
index ea0902f9f68084bbbc1bc7cf320e8186c9dadff0..0607606eeda7ee9999b87748dd80444a7db2d25f 100644 (file)
@@ -15,6 +15,7 @@ GtkAccelGroupFindFunc
 gtk_accel_group_disconnect
 gtk_accel_group_disconnect_key
 gtk_accel_group_query
+gtk_accel_group_activate
 gtk_accel_group_lock
 gtk_accel_group_unlock
 gtk_accel_group_from_accel_closure
@@ -59,7 +60,10 @@ gtk_accel_map_load_scanner
 gtk_accel_map_add_filter
 gtk_accel_map_foreach_unfiltered
 gtk_accel_map_get
+gtk_accel_map_lock_path
+gtk_accel_map_unlock_path
 <SUBSECTION Standard>
+GTK_ACCEL_MAP
 GTK_TYPE_ACCEL_MAP
 GTK_IS_ACCEL_MAP
 GTK_ACCEL_MAP_CLASS
@@ -1040,7 +1044,6 @@ GTK_ENTRY_COMPLETION_CLASS
 GTK_IS_ENTRY_COMPLETION
 GTK_IS_ENTRY_COMPLETION_CLASS
 GTK_ENTRY_COMPLETION_GET_CLASS
-GTK_ENTRY_COMPLETION_GET_PRIVATE
 <SUBSECTION Private>
 GtkEntryCompletionPrivate
 gtk_entry_completion_get_type
@@ -1175,6 +1178,7 @@ GtkFileChooserDialogPrivate
 <SECTION>
 <FILE>gtkfilechooserwidget</FILE>
 <TITLE>GtkFileChooserWidget</TITLE>
+GtkFileChooserWidget
 gtk_file_chooser_widget_new
 <SUBSECTION Standard>
 GTK_FILE_CHOOSER_WIDGET
@@ -3291,6 +3295,7 @@ GTK_SEPARATOR_TOOL_ITEM_GET_CLASS
 
 <SUBSECTION Private>
 gtk_separator_tool_item_get_type
+GtkSeparatorToolItemPrivate
 </SECTION>
 
 <SECTION>
@@ -3882,6 +3887,7 @@ GtkCellLayoutIface
 GtkCellLayoutDataFunc
 gtk_cell_layout_pack_start
 gtk_cell_layout_pack_end
+gtk_cell_layout_reorder
 gtk_cell_layout_clear
 gtk_cell_layout_set_attributes
 gtk_cell_layout_add_attribute
@@ -3906,6 +3912,7 @@ gtk_cell_renderer_get_size
 gtk_cell_renderer_render
 gtk_cell_renderer_activate
 gtk_cell_renderer_start_editing
+gtk_cell_renderer_editing_canceled
 gtk_cell_renderer_get_fixed_size
 gtk_cell_renderer_set_fixed_size
 
@@ -4229,6 +4236,7 @@ gtk_widget_add_accelerator
 gtk_widget_remove_accelerator
 gtk_widget_set_accel_path
 gtk_widget_list_accel_closures
+gtk_widget_can_activate_accel
 gtk_widget_event
 gtk_widget_activate
 gtk_widget_reparent
@@ -5075,8 +5083,10 @@ GTK_STOCK_GO_BACK
 GTK_STOCK_GO_DOWN
 GTK_STOCK_GO_FORWARD
 GTK_STOCK_GO_UP
+GTK_STOCK_HARDDISK
 GTK_STOCK_HELP
 GTK_STOCK_HOME
+GTK_STOCK_INDENT
 GTK_STOCK_INDEX
 GTK_STOCK_ITALIC
 GTK_STOCK_JUMP_TO
@@ -5085,6 +5095,7 @@ GTK_STOCK_JUSTIFY_FILL
 GTK_STOCK_JUSTIFY_LEFT
 GTK_STOCK_JUSTIFY_RIGHT
 GTK_STOCK_MISSING_IMAGE
+GTK_STOCK_NETWORK
 GTK_STOCK_NEW
 GTK_STOCK_NO
 GTK_STOCK_OK
@@ -5111,6 +5122,7 @@ GTK_STOCK_STRIKETHROUGH
 GTK_STOCK_UNDELETE
 GTK_STOCK_UNDERLINE
 GTK_STOCK_UNDO
+GTK_STOCK_UNINDENT
 GTK_STOCK_YES
 GTK_STOCK_ZOOM_100
 GTK_STOCK_ZOOM_FIT
index 39bf7c3209d4fb2e9d6452aec3248cb330ac5a5c..10de4fc6faade18f01590d8866c3bf274405d7a9 100644 (file)
@@ -2,11 +2,13 @@
 GtkCellLayout
 
 <!-- ##### SECTION Short_Description ##### -->
-
+An interface for packing cells
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+#GtkCellLayout is an interface to be implemented by all objects which
+want to provide a #GtkTreeViewColumn-like API for packing cells, setting
+attributes and data funcs. 
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -36,14 +38,15 @@ GtkCellLayout
 
 <!-- ##### USER_FUNCTION GtkCellLayoutDataFunc ##### -->
 <para>
-
+A function which should set the value of @cell_layout's cell renderer(s)
+as appropriate. 
 </para>
 
-@cell_layout: 
-@cell: 
-@tree_model: 
-@iter: 
-@data: 
+@cell_layout: a #GtkCellLayout
+@cell: the cell renderer whose value is to be set
+@tree_model: the model
+@iter: a #GtkTreeIter indicating the row to set the value for
+@data: user data passed to gtk_cell_layout_set_cell_data_func()
 
 
 <!-- ##### FUNCTION gtk_cell_layout_pack_start ##### -->
@@ -66,6 +69,16 @@ GtkCellLayout
 @expand: 
 
 
+<!-- ##### FUNCTION gtk_cell_layout_reorder ##### -->
+<para>
+
+</para>
+
+@cell_layout: 
+@cell: 
+@position: 
+
+
 <!-- ##### FUNCTION gtk_cell_layout_clear ##### -->
 <para>
 
index 61214e1da94b7ab8bd8d0d2a7651f88f4a7fa7eb..7ead3a9edc5b20f60cc8d91eee525a28beae963d 100644 (file)
@@ -2,11 +2,17 @@
 GtkEntryCompletion
 
 <!-- ##### SECTION Short_Description ##### -->
-
+completion functionality for GtkEntry
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+#GtkEntryCompletion is an auxiliary object to be used in conjunction with
+#GtkEntry to provide the completion functionality. It implements the
+#GtkCellLayout interface, to allow the user to add extra cells to the 
+TreeView with completion matches. 
+</para>
+<para>
+To add completion functionality to an entry, use gtk_entry_set_completion().
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -16,7 +22,7 @@ GtkEntryCompletion
 
 <!-- ##### STRUCT GtkEntryCompletion ##### -->
 <para>
-
+The GtkEntryCompletion struct contains only private data.
 </para>
 
 
@@ -50,14 +56,15 @@ GtkEntryCompletion
 
 <!-- ##### USER_FUNCTION GtkEntryCompletionMatchFunc ##### -->
 <para>
-
+A function which decides whether the row indicated by @iter matches a given 
+@key, and should be displayed as a possible completion for @key.
 </para>
 
-@completion: 
-@key: 
-@iter: 
-@user_data: 
-@Returns: 
+@completion: the #GtkEntryCompletion
+@key: the string to match
+@iter: a #GtkTreeIter indicating the row to match
+@user_data: user data given to gtk_entry_completion_set_match_func()
+@Returns: %TRUE if @iter should be displayed as a possible completion for @key
 
 
 <!-- ##### FUNCTION gtk_entry_completion_new ##### -->
index 20af840a37bbc916819dc653ec173598d0297d28..a1f7c56e946469c359ad15465af63b360b282b47 100644 (file)
@@ -2,21 +2,41 @@
 GtkTreeModelFilter
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A GtkTreeModel which hides parts of an underlying tree model
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A #GtkTreeModelFilter is a tree model which wraps another tree model,
+and can do the following things:
+<itemizedlist>
+<listitem><para>
+Filter specific rows, based on data from a "visible column", a column
+storing booleans indicating whether the row should be filtered or not,
+or based on the return value of a "visible function", which gets a
+model, iter and user_data and returns a boolean indicating whether the
+row should be filtered or not.
+</para></listitem>
+<listitem><para>
+Modify the "appearance" of the model, using a modify function. 
+This is extremely powerful and allows for just changing
+some values and also for creating a completely different model based on
+the given child model. 
+</para></listitem>
+<listitem><para>
+Set a different root node, also known as a "virtual root". You can pass in 
+a #GtkTreePath indicating the root node for the filter at construction time.
+</para></listitem>
+</itemizedlist>
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GtkTreeModelSort
 </para>
 
 <!-- ##### STRUCT GtkTreeModelFilter ##### -->
 <para>
-
+The GtkTreeModelFilter struct contains only private fields.
 </para>
 
 
@@ -32,25 +52,28 @@ GtkTreeModelFilter
 
 <!-- ##### USER_FUNCTION GtkTreeModelFilterVisibleFunc ##### -->
 <para>
-
+A function which decides whether the row indicated by @iter is visible.
 </para>
 
-@model: 
-@iter: 
-@data: 
-@Returns: 
+@model: the #GtkTreeModelFilter
+@iter: a #GtkTreeIter pointing to the row whose visibility is determined
+@data: user data given to gtk_tree_model_filter_set_visible_func()
+@Returns: Whether the row indicated by @iter is visible.
 
 
 <!-- ##### USER_FUNCTION GtkTreeModelFilterModifyFunc ##### -->
 <para>
-
+A function which calculates display values from raw values in the model.
+It must fill @value with the display value for the column @column in the 
+row indicated by @iter. 
 </para>
 
-@model: 
-@iter: 
-@value: 
-@column: 
-@data: 
+@model: the #GtkTreeModelFilter
+@iter: a #GtkTreeIter pointing to the row whose display values are determined
+@value: A #GValue which is already initialized for with the correct type for 
+  the column @column.
+@column: the column whose display value is determined 
+@data: user data given to gtk_tree_model_filter_set_modify_func()
 
 
 <!-- ##### FUNCTION gtk_tree_model_filter_new ##### -->
index 0c9c9031c2f461b08ca6004f08f98fb3f211294c..691e7afe8de6541fa3a879461af2fc142a5c9f69 100644 (file)
@@ -2484,12 +2484,12 @@ gtk_tree_model_filter_set_visible_func (GtkTreeModelFilter            *filter,
  * @filter: A #GtkTreeModelFilter.
  * @n_columns: The number of columns in the filter model.
  * @types: The #GType<!-- -->s of the columns.
- * @func: A #GtkTreeModelFilterModifyFunc, or %NULL.
+ * @func: A #GtkTreeModelFilterModifyFunc
  * @data: User data to pass to the modify function, or %NULL.
  * @destroy: Destroy notifier of @data, or %NULL.
  *
- * Sets the @filter to have @n_columns columns with @types. If @func
- * is not %NULL, it will set @func to be the modify function of @filter.
+ * Sets the @filter to have @n_columns columns with @types and sets 
+ * @func to be the modify function of @filter.
  *
  * Since: 2.4
  */